El Sistema de Ayuda de VisualAge permite mostrar información de ayuda en línea para ciertos productos de software de IBM. Cuando pulse F1 o seleccione un elemento del menú Ayuda desde la interfaz de usuario de uno de estos productos, debería abrirse un navegador y debería aparecer la ayuda para el producto en cuestión. Si tiene problemas al iniciar o utilizar la ayuda en línea del producto, este documento puede ayudarle a solucionarlos.
El Sistema de Ayuda de VisualAge consiste en tres componentes principales:
En la mayoría de casos, los tres componentes se ejecutan en el sistema en el que se ha instalado el producto.
Para empezar a solucionar el problema, siga los siguientes pasos:
Lea el resumen 1.2 Consideraciones especiales y, a continuación, lea todos los apartados listados que estén relacionados con su producto o entorno
Los siguientes productos de IBM utilizan el Sistema de Ayuda de VisualAge a fecha de febrero de 2001:
Si está utilizando un producto de software de IBM puesto a la venta después de noviembre de 2000 y no está en la lista anterior, puede determinar si el producto utiliza el Sistema de Ayuda de VisualAge escribiendo lo siguiente en un indicador de mandatos:
vahcfg list /f %IMNINSTSRV% | more
y buscando el nombre de su producto en las líneas que empiecen por Product:. Si su producto aparece en la lista, es que utiliza el Sistema de Ayuda VisualAge. Si no aparece en la lista, o si aparece un mensaje en el que se le advierte de que no se reconoce el mandato, puede contactar con el soporte de IBM para determinar si su producto de IBM utiliza el Sistema de Ayuda VisualAge.
Debe leer los siguientes apartados si el producto, el entorno o el problema que se describe coincide con el suyo:
En el menú Ayuda del producto, seleccione Página de Presentación de la Ayuda (o el elemento de menú equivalente de su producto). Si no hay ningún menú Ayuda disponible, intente pulsar F1 desde uno de los paneles de la interfaz de usuario de su producto. ¿Qué sucede?
Si la ayuda se muestra correctamente, los otros dos problemas potenciales son:
Si su problema no se encuentra entre los mencionados anteriormente, póngase en contacto con el soporte de IBM. Consulte http://www.ibm.com/software/ad/support para más información.
Nota: este apartado no es aplicable a Component Broker o a WebSphere Business Components. Para Component Broker consulte la información acerca de la resolución de problemas de ayuda en el directorio doc\readme.
Si no pasa nada con VisualAge para Java, Versión 3.5 y utiliza un icono de escritorio para iniciar VisualAge para Java IDE, consulte 2.1 Situación especial - VisualAge para Java, Versión 3.5.
Si no pasa nada cuando intenta iniciar la ayuda, lo primero que debe hacer es determinar si puede iniciar la ayuda desde la línea de mandatos. Para hacerlo, deberá saber en qué directorio está instalado el producto. En el texto que aparezca a continuación, siempre que vea INSTALL_DIR, deberá sustituir el directorio en el que el producto estaba instalado, por ejemplo x:\ibmvjava o "x:\Archivos de programa\IBM\VisualAge para Java". Utilice comillas para toda la vía de acceso (INSTALL_DIR seguido del subdirectorio o nombre de archivo pertinente) cuando la vía de acceso contenga espacios. Siga los siguientes pasos para intentar iniciar la ayuda desde la línea de mandatos:
g: cd "\Archivos de programa\IBM\VisualAge para Java"
dir /s /b vahelp.exe
Si a esta acción se responde con:
g:\Archivos de programa\IBM\VisualAge para Java\eab\bin\vahelp.exe
Entonces debe escribir:
cd eab\bin
Si la ayuda se inicia satisfactoriamente desde la línea de mandatos y puede realizar búsquedas en la ayuda sin problemas, puede que haya un problema con la configuración de la vía de acceso, que impide que la interfaz de usuario del producto se conecte al archivo DLL del sistema de ayuda. Consulte 2.1 Situación especial - VisualAge para Java 3.5 o, para otros productos, intente desinstalar y reinstalar el producto, puesto que hacerlo suele solucionar este tipo de problemas.
Si no le importa iniciar la ayuda desde la línea de mandatos como solución temporal o vía alternativa, puede crear un icono en el escritorio para acceder a ella. Consulte 11.0 Crear un icono para iniciar la ayuda del producto.
Si la ayuda no se carga desde la línea de mandatos, o se carga desde la línea de mandatos pero no desde el producto, es posible que no tenga configuradas las asociaciones de archivos adecuadas para el navegador en el registro de Windows. Consulte 16.0 Establecer asociaciones de archivos HTML en el registro de Windows.
Si al cambiar las asociaciones de archivos no se soluciona el problema, puede intentar lo siguiente para obtener un archivo de anotación a partir del sistema de ayuda:
En el directorio indicado por la variable de entorno TMP, debería ver uno o más archivos del tipo HTML*.C2T. Dichos archivos contienen información de anotación detallada sobre las consultas realizadas al sistema de ayuda. Puede enviar dichos archivos al soporte de IBM para que las analice. Es posible que estas consultas de soporte tengan un coste adicional. También puede examinar los archivos usted mismo para intentar descubrir la causa de la anomalía.
Si no ve ningún archivo HTML*.C2T en el directorio TEMP, intente volver a iniciar la ayuda desde la línea de mandatos. Si los archivos HTML*.C2T sólo se crean desde la línea de mandatos, el problema del producto reside en la invocación de la ayuda. Si ninguno de estos métodos para invocar la ayuda produce archivos de anotación, entonces el problema reside en el mismo sistema de ayuda. En cualquier caso puede ponerse en contacto con el soporte de IBM.
Recuerde que cuando haya terminado debe eliminar la línea HTMLHELP_LOG=1 del archivo de configuración de la ayuda del producto, puesto que el registro cronológico produciría archivos de anotación innecesarios cada vez que solicitara ayuda.
Si ninguno de estos métodos le sirve para iniciar la ayuda, compruebe que el archivo de configuración de la ayuda del producto aún sea válido. Abra INSTALL_DIR\HELP_DIR\CONFIG_FILE en un editor y compruebe que:
Para VisualAge para Java, Versión 3.5, si no puede iniciar la ayuda desde el IDE pero sí desde la línea de mandatos, puede que esté invocando el IDE por medio del acceso directo incorrecto. Esto sucede si crea manualmente un acceso directo para el IDE en el escritorio o en el menú Inicio e invoca el IDE desde dicho acceso directo. También puede tener lugar si está utilizando un acceso directo creado para la Versión 3.0 o 3.02, y ahora lo está utilizando para iniciar la Versión 3.5. Siga estos pasos para determinar si este es el problema:
Si la ayuda funciona cuando invoque el IDE desde el menú Inicio, pero no desde el icono o acceso directo que utiliza habitualmente, es posible que dicho icono o acceso directo esté indicando VAJ_INSTALL_DIR\ide\program\ide.exe, que iniciará satisfactoriamente el IDE pero no tendrá soporte para abrir la ayuda puesto que la variable de entorno PATH no señala al archivo DLL del sistema de ayuda. Puede solventar este problema editando el campo de Destino del acceso directo para indicar VAJ_INSTALL_DIR\ide\program\ivjenv.bat. Este archivo de proceso por lotes modifica las variables de entorno de Windows, de modo que la ayuda funcione correctamente desde el IDE.
Si al abrir la ayuda un navegador se abre o ir hacia el fondo, pero no puede conectarse a localhost: 49213, puede deberse a tres posibles problemas:
Consulte todos los subapartados siguientes para resolver cualquier problema con el servidor web o de mala configuración del navegador.
HTTPDL.EXE es un proceso de servidor HTTP que sólo soporta el acceso local. Forma parte del componente NetQuestion, y se utiliza para introducir páginas de ayuda en su navegador local. Compruebe que el proceso HTTPDL.EXE aparezca en su lista de tareas.
Si la tarea no aparece, puede que el sistema de ayuda no haya podido iniciarla. Primero intente invocarla desde la línea de mandatos para comprobar si envía un mensaje de error:
Cambie al directorio en el que NetQuestion está instalado (consulte 15.0 Búsqueda del Directorio de instalación de NetQuestion)
Si esto devuelve el mensaje de error El enlace del zócalo no se ha realizado correctamente, puede que un proceso HTTPDL.EXE ya esté funcionando en el puerto 49213 (el puerto TCP/IP que utiliza el proceso HTTPDL.EXE). Si aparece cualquier otro mensaje de error, póngase en contacto con el servicio de soporte de IBM. Si no devuelve ningún mensaje de error, compruebe la lista de tareas para asegurarse de que funciona correctamente. Las versiones de HTTPDL.EXE de fecha 12/02/2000 o anteriores bloquean el mandato si no detectan un error; las versiones posteriores siguen funcionando sin bloquear el indicador de mandatos. Si su versión bloquea el indicador de mandatos, pulse Ctrl+Inter y emita el siguiente mandato para iniciar el proceso como proceso separado:
nqdetach httpdl.exe -r httpd.cnf
Ahora intente actualizar la página en su navegador. Si la página se muestra correctamente, el problema del sistema de ayuda era que no podía iniciar correctamente el servidor HTTP (o, para Component Broker, el servidor no está configurado para iniciarse en el momento de la conexión). Consulte 13.0 Iniciar los servidores de NetQuestion automáticamente.
Si la página sigue sin aparecer, consulte 3.2 HTTPDL.EXE está mal configurado y 3.3 El navegador necesita alteraciones temporales de proxy.
Puede que en ocasiones el archivo de configuración httpd.cnf, utilizado por HTTPDL.EXE, contenga información acerca de la vía de acceso incorrecta. Siga estos pasos para comprobar que esté configurado correctamente:
Serverroot C:\IMNNQ_NT Exec /cgi-bin/* C:\IMNNQ_NT\* Pass /icons/* C:\IMNNQ_NT\* Pass /* C:\IMNNQ_NT\*
Compruebe que la vía de acceso indicada corresponda al directorio en el que el archivo httpd.cnf está almacenado. Si no es así, modifíquelo en todas las apariciones anteriores para reflejar la vía de acceso real.
Hostname localhost Port 49213
Sustituya todas las líneas Hostname o Port por lo mostrado anteriormente si difieren.
Algunas veces el navegador no se puede conectar al servidor web local HTTPDL.EXE, puesto que intenta localizar el sistema principal local nombrado por la máquina a través de un servidor proxy. Esto suele suceder cuando el navegador está establecido para una configuración de proxy manual o automática. Si utiliza la configuración de proxy manual, puede modificar los valores del navegador para evitar que éste intente encontrar el sistema principal local por medio de un servidor proxy. Si utiliza la configuración de proxy automática, deberá pedir al propietario de su archivo de configuración de proxy automática que añada 127.0.0.1 como excepción de proxy en el servidor proxy.
Para determinar si el navegador está preparado para realizar la configuración de proxy manual, y para añadir alteraciones temporales de proxy, siga estos pasos. Estas instrucciones son para las versiones de navegador indicadas; si utiliza una versión distinta, puede que los pasos sean distintos.
Para Netscape 4.7:
Para Internet Explorer 5.0:
También debería actualizar el archivo %SystemRoot%\system32\drivers\etc\hosts añadiendo la línea:
127.0.0.1 localhost
si el archivo existe pero esta línea aún no está. Si cambia este valor puede que necesite salir y reiniciar el navegador para que el cambio entre en vigor.
Si ha realizado cambios en la configuración del navegador o en el archivo ...\etc\hosts, intente actualizar la página de inicio de la ayuda de su navegador. Si aún recibe mensajes de error cuando intente conectarse al localhost:49213, póngase en contacto con el servicio de soporte de IBM.
Si no puede acceder al servidor proxy automático cuando intente visualizar la ayuda, puede que el navegador no pueda conectar el sistema principal local con la dirección local 127.0.0.1. Puede resolver este problema provisionalmente (mientras el servidor proxy no esté disponible) cambiando a la conexión directa a Internet en el paso 4 (Netscape) o en el paso 3 (Internet Explorer) mencionados anteriormente.
Si recibe el mensaje de error Archivo no encontrado cuando intenta ver la ayuda o iniciar una búsqueda, puede que falte un archivo del directorio de instalación de NetQuestion. Lea los apartados siguientes si desea más información.
Si recibe el mensaje de error Archivo no encontrado cuando intenta ver la ayuda, es posible que el archivo vahwebx.exe no esté en el directorio de instalación de NetQuestion 16.0 Búsqueda del directorio de instalación de NetQuestion. Compruebe el directorio en un indicador de mandatos o en el Explorador de Windows para verificar si el archivo está presente. Si lo está, es posible que haya una problema con la configuración del servidor web local NetQuestion; puede que httpd.cnf indique el directorio equivocado. Consulte el apartado anterior 3.2 HTTPDL.EXE está mal configurado. Si no se encuentra el archivo vahwebx.exe, puede intentar una o varias de las acciones siguientes:
Actualice la página del navegador. Si la ayuda funciona, el problema está resuelto. Si sigue recibiendo un mensaje de Archivo no encontrado, póngase en contacto con el servicio de soporte de IBM. Si recibe el mensaje No hay ninguna ayuda registrada para el producto xxxxx, consulte 6.0 Reconfiguración de la ayuda.
Si recibe el error Archivo no encontrado cuando intenta realizar una búsqueda en la ayuda, puede que el programa de búsqueda especificado en el formulario de búsqueda no esté instalado en la ubicación correcta. Siga estos pasos para determinar el nombre y la ubicación:
<form action="http://localhost:49213/cgi-bin/ivjsenus.exe"...> <form action="http://localhost:49213/cgi-bin/va4sall.exe"...>
El nombre del programa de búsqueda es la parte de la acción= atributo después de "cgi-bin", es decir, ivjsenus.exe o va4sall.exe en los ejemplos anteriores.
También es posible que en la página de resultados de la búsqueda aparezcan imágenes incompletas o el mensaje No se ha encontrado la cabecera del formulario de búsqueda o No se ha encontrado el pie de página del formulario de búsqueda. Dichos errores son consecuencia de la falta de ciertos archivos en el directorio de instalación de NetQuestion. Puede localizarlos en el CD del producto o obtenerlos del servicio de soporte de IBM. En el formulario de búsqueda se especifican los nombres de todos los archivos. Puede ver el código fuente del formulario de búsqueda para determinar dichos nombres. Busque los parámetros value= en los siguientes campos de entrada ocultos:
<input type="hidden" name="header" value="ivjhenus.htm"> <input type="hidden" name="footer" value="ivjfoot.htm"> <input type="hidden" name="stars1" value="ivjstar1.gif"> <input type="hidden" name="stars2" value="ivjstar2.gif"> <input type="hidden" name="stars3" value="ivjstar3.gif"> <input type="hidden" name="stars4" value="ivjstar4.gif"> <input type="hidden" name="stars5" value="ivjstar5.gif">
Las entradas resaltadas son las de VisualAge para Java. Las entradas equivalentes para otros productos incluyen, en lugar de ivj:
Un mensaje de Error interno de servidor suele indicar que una aplicación que estaba funcionando en el servidor web ha dejado de funcionar. También puede ver un diálogo de Windows con el título program.exe - Error de aplicación y un mensaje que empieza por La instrucción en"0xnnnnnnnn" ha referenciado memoria en "0xnnnnnnnn". Si no hace caso de este diálogo y selecciona Aceptar el navegador muestra el mensaje de Error interno de servidor.
Si este error tiene lugar durante una operación de búsqueda, puede que haya problemas con los índices de búsqueda del producto. Intente reconfigurar la ayuda para el producto, y a continuación vuelva a introducir la consulta de búsqueda. Si esto no resuelve el problema, póngase en contacto con el servicio de soporte de IBM.
Si este error tiene lugar durante la navegación normal de la ayuda, puede que haya problemas con los permisos del directorio en un sistema de archivos NTFS. Desconecte el sistema Windows NT o Windows 2000, vuelva a conectarse como administrador y compruebe que todos los archivos y carpetas tanto en el directorio de instalación de NetQuestion 16.0 Búsqueda del directorio de instalación de NetQuestion como en el directorio de ayuda del producto _INSTALL_DIR\doc o INSTALL_DIR\help, en función del producto) tengan los permisos de seguridad establecidos en Todo el mundo - Control total. Para hacerlo:
Si modifica los permisos, cierre estos diálogos e intente actualizar la página. Si no tuvo que modificar los permisos, o si el error persiste después de las modificaciones, intente borrar el archivo vahelp.cfg del directorio de instalación de NetQuestion, y a continuación intente reconfigurar la ayuda para el producto.
Si siguen apareciendo mensajes de Error interno de servidor, póngase en contacto con el servicio de soporte de IBM.
En algunos casos puede que el sistema de ayuda haya configurado erróneamente la ayuda para un producto concreto, o puede que usted haya tenido que eliminar información de configuración mientras intentaba realizar una instalación. Puede reconfigurar la ayuda del producto siguiendo las siguientes instrucciones. Antes de empezar, debe saber lo siguiente:
En la primera parte de este proceso debe determinarse si la ayuda ya está configurada y si sólo debe renovarse. Para determinar si la ayuda del producto ya está configurada, escriba los siguiente en un indicador de mandatos:
vahcfg list /f %IMNINSTSRV% | more
Debería ver un conjunto de listados de productos y componentes para cada producto que tiene la ayuda configurada. Si ve un producto cuyo directorio coincide con el de su producto, anote el nombre del producto. Por ejemplo, si la salida de vahcfg list incluye lo siguiente:
Product: va400 (IBM WebSphere Development Tools for AS/400 Help System) Writable directory: C:\Program Files\IBM\WDT400\help No update files for this product Comp: qadtswin (WebSphere Development Tools for AS/400) Zip file: C:\Program Files\IBM\WDT400\help\qadtswin.zip Index: va45uadt ...
El nombre del producto es va400. Si ve una entrada para el producto, puede reconfigurar la ayuda utilizando el mandato vahcfg regen. Si no ve una entrada para el producto, deberá reconfigurar la ayuda utilizando el mandato vahcfg install. Ambos serán tratados más adelante en este apartado.
Antes de ejecutar vahcfg regen o vahcfg install, deberá asegurarse de que el disco en el que se ubica el directorio de la documentación tenga el suficiente espacio libre para albergar los índices de búsqueda para la ayuda del producto. Dichos índices se extraen de los archivos *.zip del directorio de la documentación, y se graban en subdirectorios del directorio de la documentación por medio del programa vahcfg. Por norma general, debería tener como mínimo el mismo espacio libre en disco que el utilizado en los archivos zip del directorio de la documentación.
Para ejecutar vahcfg regen, emita el siguiente mandato:
vahcfg regen /p prodname /f %IMNINSTSRV%
donde prodname coincide con el nombre del producto que usted anotó cuando ejecutó vahcfg list.
Para ejecutar vahcfg install, emita el siguiente mandato:
vahcfg install /w docdir /f %IMNINSTSRV%
donde docdir es la vía de acceso completa al directorio que contiene los archivos de ayuda del producto. Si dicho directorio tiene espacios entre sus elementos (por ejemplo, c:\Archivos de programa\IBM\..., ponga toda la vía de acceso del directorio entre comillas.
Después de la instalación o regeneración (que puede llevar varios minutos), intente volver a cargar la ayuda. Si el problema que intentaba subsanar persiste, siga los pasos que aparecen en 6.5 Obtención de un archivo de anotaciones cronológicas de vahcfg regen o vahcfg install, póngase en contacto con el servicio de soporte de IBM y envíele el archivo de anotaciones cronológicas.
Si intentó regenerar o instalar la ayuda para el producto por medio de vahcfg regen o vahcfg install, y el intento no subsanó los problemas de la ayuda, intente lo siguiente para producir un archivo de anotaciones cronológicas que el servicio de soporte de IBM pueda utilizar para encontrar la causa del problema:
A continuación puede entregar el archivo de anotaciones cronológicas generado al servicio de soporte de IBM.
Tenga en cuenta que las primeras versiones de vahcfg no producen archivos de anotaciones cronológicas. Las versiones que no soporten el registro cronológico mostrarán todos los resultados en la pantalla; las versiones que sí lo soporten imprimirán un mensaje indicando donde se ha registrado la información.
El sistema de búsqueda de NetQuestion es extremadamente rápido buscando coincidencias en todas sus consultas, excepto en las más genéricas. Si busca coincidencias en la serie a*, el sistema de búsqueda debe encontrar todos los documentos que contengan al menos una palabra que empiece con la letra a, de modo que este proceso siempre lleva más tiempo. Sin embargo, si la búsqueda es específica, recibirá los resultados de la búsqueda en pocos segundos como máximo. Si la búsqueda se alarga demasiado (por ejemplo más de un minuto), puede que tenga un problema relacionado con la utilización de Netscape Navigator 4.5 o superior en un sistema Windows 2000. (Este problema también se da en algunos sistemas Windows NT).
Existe un problema conocido con Netscape (versiones 4.5 y 4.74, y es posible que en otras) en algunos sistemas Windows 2000, lo que puede provocar que la búsqueda en la ayuda en línea sea extremadamente lenta. Cuando envía un formulario desde estas versiones de Netscape, la aplicación de Netscape utiliza la mayoría de ciclos de procesador disponibles en el sistema hasta que recibe una respuesta de un sistema remoto. (Puede comprobarlo abriendo la página del Gestor de Tareas de Windows durante una búsqueda, abriendo la pestaña Procesos y pulsando en la cabecera de columna de CPU. Si tiene este problema, aparecerá netscape.exe en la parte superior de la lista, y estará utilizando entre el 97 y el 99% del tiempo de la CPU).
Esta utilización de la CPU no supone ningún problema cuando se realiza una búsqueda remota (por ejemplo, en un sitio web). Sin embargo, puesto que el programa de búsqueda del producto está en funcionamiento en su sistema local, el hecho de que Netscape ocupe tanto tiempo de la CPU implica que queda muy poco tiempo para que el programa de búsqueda lleve a cabo su búsqueda. En consecuencia, una búsqueda que debería mostrar un resultado en un segundo puede tardar varios minutos en Windows 2000.
Puede evitar este problema de rendimiento en Windows 2000 seleccionando una ventana distinta, que no sea de Netscape, cada vez que inicie una búsqueda. Esto hace que Netscape deje de utilizar demasiados ciclos de CPU mientras espera una respuesta, y que los resultados de la búsqueda se muestren un segundo después de este cambio de ventana. La misma técnica también puede funcionar en Windows NT, aunque no de forma tan eficiente.
Como alternativa también puede utilizar Microsoft Internet Explorer para ver la ayuda, puesto que el problema de rendimiento no se da con este navegador.
Es posible que reciba uno de los siguientes mensajes de error cuando realice una búsqueda en el sistema de ayuda desde el navegador:
Esto puede suceder en dos situaciones:
El código de retorno de 73 no suele enviarse tras una petición de búsqueda realmente vacía, sino sólo en los casos en los que la petición contiene sólo palabras vacías. Si puede reproducir fielmente el mensaje que indica una petición de búsqueda vacía cuando la serie de búsqueda no está vacía (y no está formada sólo por palabras vacías), puede que el formulario de búsqueda se haya corrompido. Localice los formularios de búsqueda hgssrch.htm y hgcsrch.htm en el directorio de ayuda del producto (generalmente DIR_INSTAL\doc o DIR_INSTAL\help) y envíelos a su representante del servicio de soporte de IBM.
Puede que cuando intente realizar una búsqueda reciba otros mensajes de error. Si el error es uno de los siguientes, intente la acción recomendada antes de ponerse en contacto con el servicio de soporte de IBM.
Causa: El cliente de la ayuda no ha podido iniciar el servicio de búsqueda (o, para Component Broker, el servicio de búsqueda no está configurado para iniciarse automáticamente en el momento de inicio de sesión). Esto puede tener lugar si está buscando en el sistema local (http://localhost:49213) o en un servidor de ayuda remoto.
Acción recomendada (ayuda local):
Consulte 3.1 HTTPDL.EXE no se está ejecutando y en concreto el apartado que trata la importación de las entradas de registro de inicio automático, para que el servicio de búsqueda se inicie automáticamente cuando inicie la sesión. Para agilizar este proceso, puede abrir un indicador de mandatos y escribir:
imnss start serverSi este mandato devuelve un mensaje que incluye la línea:
El servicio de búsqueda se ha iniciado.entonces debería poder realizar búsquedas de nuevo, sin el error rc=33.
Acción recomendada (ayuda desde servidor remoto):
Puede que el proceso de búsqueda NetQuestion del servidor del sistema no funcione porque se ha reiniciado el sistema y no hay nadie conectado en ese momento. Consulte 14.0 Inicio del servicio de búsqueda NetQuestion al arrancar el sistema.
Causa: El programa de búsqueda no ha recibido ningún nombre de índice válido en la petición de búsqueda. Puede que el formulario de búsqueda se haya corrompido, que los índices especificados ya no estén registrados o que haya un problema en la instalación de NetQuestion.
Acción recomendada: En primer lugar, suprima todos los archivos hg*.htm del directorio de ayuda del producto (DIR_INSTAL\doc o DIR_INSTAL\help). A continuación, intente reconfigurar la ayuda para el producto. Si el problema persiste, es posible que necesite reinstalar NetQuestion y, a continuación, reconfigurar de nuevo la ayuda para el producto.
Causa: El formulario de búsqueda ha especificado una cabecera o pie de página inexistentes (archivos que contienen un fragmento HTML que debe colocarse encima o debajo de los resultados de la búsqueda).
Acción recomendada: Consulte 4.2 Errores de Archivo no encontrado cuando se intenta realizar una búsqueda para obtener más información.
Causa: Ha introducido una consulta de búsqueda que tiene demasiadas palabras coincidentes. El motor de búsqueda no puede manejar una consulta que contenga coincidencias con más de 1024 palabras distintas. Por ejemplo, si introduce la serie de búsqueda "a* b* c* d*" (sin los asteriscos), está pidiendo todos los documentos que contengan palabras que empiecen por las letras a, b, c, o d. Puesto que hay demasiadas palabras que coinciden con este criterio de búsqueda, el motor de búsqueda no puede crear una lista de resultados coherente y ordenada, lo que provoca que ni tan sólo lo intente.
Acción recomendada: Introduzca una petición de búsqueda que genere menos coincidencias.
Causa: Ha introducido una consulta de búsqueda que no es válida desde el punto de vista lógico. Por ejemplo, una consulta de búsqueda de "-java" (mostrar todos los documentos que no contengan la palabra java) no se considera válida.
Acción recomendada: Introduzca una petición de búsqueda que contenga como mínimo un término no prohibido.
Causa: Este error puede producirse cuando el programa de búsqueda no puede leer las variables de entorno necesarias para que la operación de búsqueda se realice satisfactoriamente. Si ha configurado la ayuda para que funcione en un servidor web que no es el servidor web HTTPDL.EXE de NetQuestion, es posible que deba cambiar los valores del servidor web para garantizar que ciertas variables de entorno sean visibles para el CGI de búsqueda (el programa que se invoca desde el parámetro "action=" de la etiqueta <form> dentro del formulario de búsqueda). En algunos servidores web, las variables de entorno del sistema se ocultan por omisión. Las variables a las que el CGI de búsqueda necesita acceder son IMNINSTSRV e IMNINST. Netscape Enterprise Server es un ejemplo de servidor web que oculta las variables de entorno por omisión.
Acción recomendada: Modifique los valores del servidor web, tanto para exportar estas variables de entorno a las aplicaciones del servidor web CGI manualmente como para hacer todas las variables de entorno locales visibles para los CGI. En Netscape Enterprise Server puede hacerlo por medio de los siguientes pasos:
set imn
El sistema debería devolver los valores de las variables IMNINST y IMNINSTSRV, como pueden ser:
IMNINST=help IMNINSTSRV=C:\IMNNQ_NT
Init fn="init-cgi" IMNINSTSRV=c:/imnnq_nt Init fn="init-cgi" IMNINST=help
"ADVERTENCIA: Los archivos de configuración se han editado manualmente. Utilice este botón para cargar los archivos de configuración más recientes."
pulse Cargar archivos de configuración.
Para otros servidores web, consulte la documentación de dichos servidores para obtener más información si desea hacer visibles las variables de entorno para las aplicaciones CGI.
Causa: Un error rc=32 o un error que menciona el archivo NETQ.CFG tiene lugar cuando NetQuestion no puede acceder adecuadamente a un índice de productos. Esto puede ser debido a que la instalación de NetQuestion o un índice concreto se hayan corrompido, o también puede suceder sólo en la primera búsqueda que realice en un índice determinado después de rearrancar el sistema. Tenga en cuenta que aunque el mensaje para algunas formas de este error mencione el archivo NETQ.CFG, este archivo no existe realmente; el error se refiere a problemas con otros archivos de configuración de índices de NetQuestion.
Acción recomendada: Determinar la causa más probable del problema y corregirlo como se describe a continuación:
Si una búsqueda devuelve un mensaje de error rc=76, puede que uno o más de los índices de búsqueda deban restablecerse. Siga estos pasos para restablecer los índices:
En algunos casos el único modo de que la ayuda funcione correctamente es desinstalar y a continuación reinstalar NetQuestion, para después reconfigurar la ayuda para los productos que utilicen el Sistema de Ayuda VisualAge. Tenga en cuenta que desinstalar NetQuestion puede eliminar índices de búsqueda utilizados por los productos, como IBM DB2, que no utilizan el Sistema de Ayuda de VisualAge, y que por lo tanto pueden bloquear las búsquedas de los productos después de la reinstalación de NetQuestion. Puede que deba reinstalar el producto en cuestión para restaurar sus índices de búsqueda.
En las siguientes instrucciones, emita todos los mandatos desde un indicador de mandatos. Antes de empezar, deberá encontrar el directorio de instalación de NetQuestion.
El programa de desinstalación de NetQuestion, uninstnq.exe en el directorio de NetQuestion, eliminará NetQuestion sólo si no hay índices registrados. Puede eliminar en primer lugar todos los índices registrados por los productos que utilicen el Sistema de Ayuda de VisualAge emitiendo el mandato vahcfg remove para cada producto. Siga estos pasos:
Después de eliminar todos estos productos puede comprobar si aún hay índices registrados para otros productos por medio del siguiente mandato:
imnixlst
Si la lista resultante contiene entradas que empiecen por DB2, CXX, o VAC, es posible que tenga índices registrados con productos como DB2, IBM C y C++ Compilers o VisualAge C++ 4.0, que no utilizan el Sistema de Ayuda de VisualAge. Si prosigue con la desinstalación manual de NetQuestion, perderá todos estos índices y puede que deba reinstalar los respectivos productos para volver a realizar búsquedas en la ayuda de dichos productos. Si estos índices aún están listados y usted está preparado para perder posibilidades de búsqueda para estos productos o para reinstalarlos, prosiga y suprima los índices restantes como se muestra a continuación:
Si los índices cuyo nombre empieza por IVJ3, VJ32, IWZ o VA45 están listados, resulta seguro suprimirlos puesto que pueden restaurarse más adelante por medio de vahcfg install.
Si no puede suprimir todos los índices restantes debido a un error en NetQuestion, puede que deba eliminar NetQuestion de forma manual (consulte el apartado 11.4 más adelante).
Emita el mandato uninstnq y espere unos minutos, hasta que el directorio de NetQuestion esté prácticamente vacío. El directorio no debe contener ningún archivo que empiece por imn* o imq*. Puede que deba esperar hasta diez minutos para que esta operación se realice completamente. Si después de diez minutos el directorio aún contiene archivos imn* o imq*, puede que aún haya índices registrados en el servicio de búsqueda (en cuyo caso, vuelva al apartado 11.2), o que la instalación de NetQuestion esté dañada (siga hasta la sección 11.4). En cualquier otro caso, rearranque el sistema y consulte el apartado 11.5.
Si no puede eliminar NetQuestion por medio de uninstnq.exe, puede eliminarlo de forma manual siguiendo las siguientes instrucciones:
Para modificar o eliminar las variables de entorno, siga los siguientes pasos teniendo en cuenta su sistema operativo:
Para reinstalar NetQuestion, necesitará el CD del producto o un archivo zip de instalación del servicio de soporte de IBM. Los siguientes productos cuentan con una copia instalable de NetQuestion en su CD del producto:
Para otros productos, puede comprobar si existe una copia instalable de NetQuestion en el CD buscando un archivo llamado ntq_sbcs.iss. El directorio que contiene dicho archivo incluye un archivo setup.exe que puede iniciar la instalación de NetQuestion.
Si recibe un archivo zip de instalación del servicio de soporte de IBM, descomprímalo en un directorio temporal.
Una vez haya obtenido una copia instalable de NetQuestion, siga estos pasos:
Para todos los productos que eliminó manualmente del sistema de ayuda (utilizando vahcfg remove, como se muestra en el apartado 11.1), ejecute vahcfg install como aparece en 6.0 Reconfiguración de la ayuda. Ahora debería poder examinar y realizar búsquedas en la ayuda del producto. Si los errores persisten, compruebe otros apartados de este documento para consultar posibles soluciones, o póngase en contacto con el servicio de soporte de IBM.
Si no puede iniciar la ayuda desde el interior de la interfaz de usuario del producto, puede crear un icono para iniciarla pulsando dos veces sobre un icono (de modo que al menos pueda utilizar la ayuda mientras está ocupado en la resolución del problema).
Notas
Puede crear un acceso directo para iniciar la ayuda del producto de la siguiente manera:
instance "INSTALL_DIR\DOC_DIR\CONFIG_FILE" open index.htm
donde INSTALL_DIR es el directorio en el que se instala el producto, DOC_DIR suele ser doc o help, y CONFIG_FILE es el nombre del archivo de configuración de la ayuda del producto (ivjhlp.cfg para VisualAge para Java; consulte 2.0 No pasa nada al intentar iniciar la ayuda para obtener más información acerca de la búsqueda de directorios y nombres de archivos de configuración para otros productos). Asegúrese de que la ruta completa del archivo de configuración esté entre comillas si dicha ruta contiene espacios.
Puede añadir el icono creado al menú Inicio pulsando el botón derecho sobre el icono, seleccionando Copiar en el menú emergente, y a continuación desplazándose por el Explorador de Windows a través del directorio de instalación de Windows, en ...\Pefiles\All Users\Menú Inicio, y pegándolo en el directorio o en el subdirectorio de su elección.
Puede instalar y configurar el sistema de ayuda en un servidor web Windows NT o Windows 2000, de modo que otros miembros de su organización puedan ver y realizar búsquedas en la ayuda en línea a través de la red sin necesidad de utilizar el código de NetQuestion y el sistema de ayuda instalado en sus estaciones de trabajo.
Notas de producto
Para realizar esta instalación en red, debe tener instalado en el sistema software para el servidor web, como Microsoft Peer Web Services (PWS) o Microsoft IIS. El servidor web debe tener un directorio de scripts. (En PWS y IIS, su directorio de scripts suele ubicarse en x:\inetpub). Después de instalar el software del servidor, siga los siguientes pasos:
vahwebx.exe vahwebx.cat vahelp.cfg *foot.htm *head.htm *henus.htm
Los tres primeros archivos son obligatorios; los siguientes deben copiarse si se encuentran en el directorio, pero si no están en el directorio NetQuestion no serán necesarios en el directorio x:\inetpub\scripts.
HTML_HOSTNAME=servidor.ciudad.dominio.organización CGI_BIN_DIR=scripts START_LITE_DAEMON=0 START_NETQ_DAEMON=0
Los usuarios ya deberían poder acceder a la ayuda establecida en el servidor simplemente pulsando F1 o seleccionando un elemento del menú Ayuda desde su aplicación de IBM. También pueden acceder a la ayuda por medio de la siguiente URL:
http://Su nombre de sistema principal/scripts/vahwebx.exe/help/nombre_producto/Extract/0/index.htm
donde nombre_producto es:
Si más adelante ejecuta vahcfg install o vahcfg regen en el sistema servidor, deberá editar de nuevo el archivo de correlación del paso 3 mostrado anteriormente.
Cuando los usuarios hayan modificado los archivos de configuración de la ayuda del producto en el servidor, pueden ejecutar sin ningún riesgo el siguiente mandato para suprimir todos los archivos *.toc, *.htm, y*.zip, así como los archivos de índices de búsqueda desde el directorio de ayuda del producto:
vahcfg remove /p nombre_producto /f %IMNINSTSRV%
o pueden simplemente suprimir los archivos *.toc, *.htm y *.zip manualmente. Sin embargo, este método no suprimirá los directorios de índices del directorio de ayuda del producto, por lo que también deberán suprimirse manualmente.
Consulte 14.0 Inicio del servidor de búsqueda de NetQuestion al arrancar en lugar de este apartado si está configurando el servidor en una configuración de ayuda en red.
Puede configurar los servidores HTTP y de búsqueda para que se inicien automáticamente cuando se inicie la sesión estableciendo dos entradas de registro en el sistema. Para hacerlo, siga estos pasos:
REGEDIT4 [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Run] "IMNNQ"="nqdetach.exe imnss.exe start server" "IMNNQ NetQ Web Server"="nqdetach.exe httpdl.exe -r %IMNINSTSRV%\\httpd.cnf"
Esta acción importará dos entradas en el registro, de modo que la próxima vez que se conecte (o cuando rearranque el sistema en Windows 95, Windows 98 o Windows ME) los servidores deberían iniciarse automáticamente.
Si está utilizando una configuración de ayuda en red en la que la ayuda se envía desde un servidor y no desde su propio sistema, puede que tenga problemas realizando búsquedas en un sistema remoto. Cuando el daemon de búsqueda de NetQuestion está configurado para iniciarse automáticamente (durante la instalación del producto, o después de completar los pasos en 13.0 Inicio automático de los servidores de NetQuestion) el daemon no se inicia hasta que un usuario se conecta al equipo en el que se encuentra el servidor. Esto significa que después de rearrancar el sistema, antes de que el usuario del sistema se haya conectado, el daemon de búsqueda no está funcionando. Sin embargo, puede utilizar el Programador de tareas de Windows para iniciar el daemon de búsqueda en el momento del rearranque. Las instrucciones que se ofrecen en este apartado van dirigidas al sistema que envía la ayuda.
Nota: Si no está utilizando una configuración de ayuda en red, no hace falta que siga los pasos de este apartado.
Antes de empezar, debe definir el directorio de instalación de NetQuestion. También es recomendable que limpie manualmente su registro. El registro puede contener entradas para iniciar el daemon de búsqueda de NetQuestion en el momento del inicio de sesión. Si va a iniciar el daemon en el momento del rearranque, la entrada del registro no es necesaria. Para limpiar el registro:
Ahora puede hacer que Windows inicie los servidores en el momento del rearranque. Primero, compruebe que el Programador de tareas de Microsoft Windows esté instalado en el sistema que ejerce de servidor de ayuda:
Para configurar el Servidor de Búsqueda de NetQuestion para que se inicie en el momento del rearranque en el servidor de ayuda:
Nota: Después de rearrancar el sistema del servidor de ayuda, puede que después de aparecer la pantalla de inicio de sesión Windows tarde un minuto o más en iniciar el servidor de búsqueda.
Puede encontrar la ubicación del directorio de instalación de NetQuestion abriendo un indicador de mandatos y escribiendo:
set IMNINSTSRV
El directorio que aparece a continuación es el directorio de instalación de NetQuestion. Si la variable no está configurada, puede encontrar el directorio de instalación buscándolo en el registro de Windows. Introduzca regedit en un indicador de mandatos y expanda las entradas del registro hasta la clave HKEY_LOCAL_MACHINE\SOFTWARE\IBM\NetQuestion\CurrentVersion\Installation Directory. La entrada "Directory" de dicha clave debe indicar el directorio de instalación de NetQuestion.
En Windows 95, Windows 98 y Windows ME, si la variable de entorno IMNINSTSRV no está configurada pero puede encontrar el directorio en el registro, puede que necesite editar el archivo autoexec.bat (si se encuentra en esta situación en Windows Millennium Edition, consulte 17.0 Consideraciones especiales para Windows Millennium Edition). El proceso de instalación de NetQuestion debe haber modificado autoexec.bat para añadir un mandato que llame al archivo de proceso por lotes imnenv.bat almacenado en el directorio de NetQuestion. El mandato añadido es el siguiente:
if exist _NETQ_DIR_\imnenv.bat call _NETQ_DIR_\imnenv.bat
Si no encuentra esta línea, o _NETQ_DIR_ apunta al directorio equivocado, añada la línea con el directorio NetQuestion correcto. También debería comprobar que el archivo de proceso por lotes imnenv.bat que se está llamando en autoexec.bat exista realmente y que contenga entradas que apunten al directorio actual y no a otro directorio de NetQuestion. El contenido de imnenv.bat debería ser:
@echo off set IMNINSTSRV=_NETQ_DIR_ set IMNINST=help set PATH=PATH;%IMNINSTSRV%
Si no puede lanzar la ayuda desde el navegador ni desde una línea de mandatos, es posible que no tenga configuradas las asociaciones adecuadas para archivos HTML. El código del cliente del sistema de ayuda utiliza entradas de registro para determinar el navegador por omisión del sistema basándose en estas asociaciones de archivos. Con el Editor del registro, puede comprobar sus asociaciones de archivos:
Si no ve esta entrada, puede añadirla del modo siguiente:
Para Netscape Communicator:
user_pref("browser.wfe.ignore_def_check", true);
Para Internet Explorer:
Si está utilizando Windows Millennium Edition, puede que los cambios que realice en autoexec.bat para cargar las variables de entorno de NetQuestion no entren en vigor incluso después de rearrancar el sistema; puede que los cambios desaparezcan después del rearranque. Esto puede hacer que las variables de entorno de NetQuestion permanezcan sin definir, lo que puede provocar las siguientes anomalías:
Puede determinar si esto es la causa de los problemas en la ayuda comprobando, después del rearranque, si las variables de entorno están establecidas correctamente. Si aún no están establecidas, puede utilizar el programa msconfig.exe que se encuentra en el directorio del sistema de Windows para realizar los siguientes cambios:
Component Broker no utiliza la parte del cliente del Sistema de Ayuda de VisualAge, es decir, la parte que inicia la ayuda desde F1 o desde una acción del menú Ayuda en la interfaz de usuario. Esto conlleva dos consecuencias importantes:
Component Broker proporciona información adicional acerca de la resolución de problemas en el directorio doc\readme.
En los sistemas en los que la ayuda instalada está escrita parcial o totalmente en chino simplificado (entorno local zh_CN), taiwanés (zh_TW), coreano (ko_KR) o japonés (ja_JP), deberá realizar cambios en los mandatos de NetQuestion y vahcfgand, como se muestra a continuación:
vahcfg regen /p vj32 /f %IMNINSTSRV% /l ja_JP
Si no incluye el entorno local puede que se dañen los índices de búsqueda y el sistema de búsqueda de NetQuestion.
| Mandato SBCS | Mandato DBCS |
| imnixlst | imqixlst |
| imnixdel | imqixdel |
| imnss start server | imqss -start dbcshelp |
Estos cambios son necesarios puesto que NetQuestion utiliza distintos servidores y archivos ejecutables para sus sistemas de búsqueda de byte único y de doble byte.